Allegro ID#:    3653
Name:           Jakub Wasilewski
Entry name:     Garbage Quest
Link:           http://wasyl.eu/garbagequest/

--------------------------------------------------
  ACKNOWLEDGEMENTS
--------------------------------------------------

Thanks to:
	- Todd Cope - for DUMBA5, thanks to which the game has music!
	- Matthew Leverton - for help in getting said A5 to work.
	- everyone on #allegro-speedhack
	
The modules used in game are:
	Dreamland, by andyk
	Unreal Superhero, by radix

--------------------------------------------------
  COMPILING
--------------------------------------------------

Use the makefile provided. It has a switch that recognizes whether you
are under MinGW or a Linux system. If you use neither, you'll have to
tweak the makefile yourself, i'm afraid... Start with one of the
Makefile.mingw or Makefile.linux files and work from there.

You will have to have certain libraries installed beforehand:

	-	Allegro 4.9.12, with
		- sndfile support - this is necessary for sound to work
		- PNG
		- TTF
		- iio 
		- kcm_audio
		- primitives
	-	DUMB 0.9.3     - for MOD playback

If you don't feel like compiling follow the link on top of this
document for Windows binaries.

--------------------------------------------------
  RUNNING THE GAME
--------------------------------------------------

Use the "gquest" executable. The game expects to have write permission to 
the folder it resides in (storage for unlockables data), so if you are 
under Linux keep that in mind.

You can try fullscreen by running it with the secret switch "-fs". 
It's a little buggy though - alt+tab doesn't work properly. 
You have been warned :).

--------------------------------------------------
  RULE COMPLIANCE
--------------------------------------------------

1. Fantastically mundane.

What could be more mundane than taking out the garbage? Well, unless you
live in a fantasy land with garbage eating monster, that is...

2. Dynamic environment.

Most levels include some form of switches that allow you to change the
shape of the level - adding new tiles or removing some. Of course, there 
are also other ways to interact with the environment: for example, you 
can grab any creature and move it to a new place in order to solve the 
level.

3. Zoom, zoom.

The game zooms in on the victory pose after you win a level.
 
4. Unlockable content.

The game features graphical themes, which are unlocked by completing
levels. Additionally, the levels themselves start locked and have to
be unlocked by playing previous ones. There is also a surprise for
when you complete all the levels!
 
5. Post-Mortem

A window detailing various interesting information about the playthrough
is provided after you win a level. A window describing your death appears
after your character dies.

----------------------------------------------------
  THE AIM OF THE GAME
----------------------------------------------------

Toss the garbage away! Each level has one or more containers, which have
to be filled with garbage bags. You have to pick up the garbage bags,
carry them to the containers and throw them inside. Each container has
a number on its side that indicates how many bags it needs.

Additional achievement points are awarded for:
	- collecting all the loose garbage on a level.
	- collecting all the loose garbage and winning the level under
	  a level-specific time limit.

----------------------------------------------------
  CONTROLS
----------------------------------------------------

  Z - jump button
  X - pick up/throw button
  	- down+X - pick up object
  	- down+X, while carrying something - drop object
  	- X, while carrying something - throw object
  	- up+X, while carrying sth - high throw
  	- run+X, while carrying - strong throw
  ARROWS - moving/ducking
